# Demonstration script for JACOsub subtitle playing software.
# This script demonstrates the flexibility of the JACOsub file format,
# going through nearly all of the features available.
# The JACOsub script player itself is compatible with TurboTitler and
# Arizona Anime Society scripts; however, if you want to use some of the
# more advanced features, like italics, color control, and text
# positioning, you need to use the jconvert utility to convert your
# script to JACOsub format.
# Now let's begin....
# First, let's set up some defaults. Time units default to SMPTE (1/30
# second units. We'll use 1/100 seconds because it's simpler to
# understand for now.
#T100 (this sets time units to 1/100 second)
#R2.2 (lengthen total playing duration by 2.20 seconds)
# Let's change a default colors while we're at it....
#P1 0 14 0 (set color palette 1 to green - for "slow" text)
# Now, show an introductory title centered on the screen for 4 seconds.
# This line demonstrates the newline escape character, or manual
# wordwrap. The new substrings created will also be word-wrapped
# automatically if they don't fit within the default width limits.
# You can always turn wordwrapping off for a line with the W0 directive.
0:00:00.00 0:00:04.00 VM JACOsub\n\nThis script demonstrates some of the capabilities of JACOsub.
# The next 3 lines demonstrate vertical positioning and overlapping time
# ranges. Notice how the times for each of the lines are set. Only
# between times 5.33 and 6.33, all 3 lines are present on the screen.
0:00:04.00 0:00:06.33 VT Text may be positioned at the top,
0:00:04.66 0:00:06.66 VM middle,
0:00:05.33 0:00:06.99 VB or bottom of the screen.
# The next line shows how you can insert comments inside the text. This
# is useful for making notes about translations and character names when
# subtitling foreign films.
0:00:07.40 0:00:10.80 VM {this is a comment} (And, as you just saw, {another comment} timing ranges for different lines of text may overlap.)
# Now we demonstrate left/right/center justification
0:00:11.00 0:00:13.50 JL Within margin constraints that you set,\ntext may be left justified,
0:00:13.50 0:00:14.75 JC {the JC is reduntant - it's the default} center justified,
0:00:14.75 0:00:16.00 JR and also\nright justified.
# Here we show what you can do with margin settings. The first line
# sets the right margin to 33% of the screen (left margin is at 0%), and
# the second line sets the left margin at 50% of the screen (right
# margin is at 100%). We also demonstrate two fonts on the same screen.
0:00:15.60 0:00:22.00 VTHR33 You can, for example, set your margins so that text is confined to the left 1/3 of the screen.
0:00:17.50 0:00:22.00 VBHL50F1 And you can place other text (with a different font, even!) elsewhere by setting different margins for it.
# Now we demonstrate different text styles and colors. Notice here we
# use the VL directive to position the text on different lines.
0:00:22.30 0:00:28.01 VL3 You may have different text styles\n(Normal, \BBold, \IItalic\N)
0:00:22.30 0:00:28.01 VL5 and different \C1colors
# Notice here the default text color has been
# changed to 1 and restored to 3 inside the text.
0:00:24.00 0:00:28.01 CF1VL7 all \C3mixed \C1\Itogether!
# Here's a trick. We will rapidly cycle through some blank screens
# so that the current display will "catch up" to the background display
# buffer being generated. We use color 1 text here, which is slow.
0:00:28.01 0:00:28.02 D ~
0:00:28.02 0:00:28.03 D ~
0:00:28.03 0:00:28.04 D ~
0:00:28.04 0:00:28.05 D ~
0:00:28.05 0:00:32.00 CF1VM Here the display was intentionally "caught up" to the background generation, to show how slowly color 1 text is generated in the background.
# Now explain to the user why this happened. Here we also demonstrate
# the VU directive to show how you can continue a long line of text
# underneath previous one.
# Here we also demonstrate background shading,
# in the second "continued" line.
0:00:32.30 0:00:43.00 GB63T120CF1VM You will see that sort of foreground generation if you use a lot of ``slow'' color 1 text.\n\C3(Color 3 text is very fast.)
0:00:32.30 0:00:43.00 CF1VUCS8 \n\nPlan your timings so the display won't catch up to the view being generated in the background.
# Demonstrate backgrounds that are opaque to the genlock, by specifying
# a text background color. This will clear the whole screen to that
# color before any text is drawn on it.
0:00:43.00 0:00:50.00 CB1VM You can change the screen background color, too.\n\nThis is useful if you want to make an opaque screen when using a genlock.
# Demonstrate the #Include command.
#I 0:00:50.00 idemo # include another script offset by 50 seconds
# Display a sayonara message:
0:00:58.00 0:01:03.00 VM OK, this script will be finished when the screen goes blank.\n\nPress any key to exit.
# You probably noticed that most of the lines above used the VM (Vertical
# Middle) directive. We could have made this the default, by specifying
# the global command #DVM near the beginning of the file. Then we
# wouldn't have had to specify VM on each line, but we would have had to
# specify VB (the former default) for those lines positioned at the bottom